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Congratulations'. You have just purchased THE 
program which helps you solve the hardest part of 
BASIC programmlng for your ATARI home computer, 
debugging your program after writing it. MMG BASIC 
DEBUGGER is a set of tools that will let you look 
inside a BASIC program while 1t 1s being executed, 
follow the path of the program, examine variables 
and modify the program during a run. Some features 
of MMG BASIC DEBUGGER are TRACE (many options), 
SEARCH, SPLIT SCREEN, SCROLL ING two parts of your 
BASIC program simul taneously, CROSS REFERENCING of 
variables, and two dlsplay screens. Each feature 
has several options accessed by one or two letter 
conmands. To ful1y master thls collection of 
programs, a thorough reading of this documentation 
is necessary. The easiest way to fam111arize 

yourself with the operation of thls debugger 1s to 
boot-up your computer with the MMG BASIC DEBUGGER 
disk, and then LOAD “D:DEM0", a BASIC program 
Included on your disk. The instructions below can 
then be tested as they are described. 

UARNING 

DO NOT ATTEMPT TO WRITE TO YOUR MMG BASIC DEBUGGER 

DISK! 

DO NOT REM0VE THE WRITE-PROTECT TAB FR0M THE DISK 
EITHER 0F THESE ACTIONS WILL V0ID YOUR WARRANTY 

ALWAYS HAVE A BACKUP COPY 0F THE PROGRAM 

YOU ARE DEBUGGING ON ANOTHER DISK!! 
★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★ 


GETTING STARTED 


Turn on your disk drive, and v/ait for the top 
red light to go out. Insert the MMG BASIC DEBUGGER 
disk, and close the door of the disk drive firmly. 
Check to be sure that your ATARI BASIC cartridge is 
correctly inserted in your computer, and close the 
cover securely. Turn on your monitor or TV, and 
then turn on your ATARI computer. MMG BASIC 
DEBUGGER will automatically load into your 
computer's memory. Uhen the drive has stopped, 
REM0VE the MMG BASIC DEBUGGER disk, and put it in a 
safe place. Insert a disk containing the BASIC 
program you wish to debug (BE SURE YOU HAVE A 
BACKUP 0F THE PROGRAM ON ANOTHER DISK), and type 
LOAD "D:filename.ext", where, in place of 
filename.ext, you type the name of your BASIC 
program. To follow our examples, the file name to 
use is "D:DEM0". Then hit the RETURii key. 

Throughout this documentation, reference to 
C0NTR0L-Z, for examp1e, means that you hold down 
the CTRL key while hitting the letter Z. CONTROL-T 
then refers to holding down the CTRL key while 
hitting the letter T. Reference to SHIFT-C0NTR0L-D 
means that you hold down both the SHIFT and CTRL 
keys together, while hitting the letter D. 

AUKILIARY SCREEN 

The first feature you should become aquainted 
with is the auxiliary screen. This screen is 
accessed by pressing C0NTR0L-Z (or D during trace). 
The primary use of the auxiliary screen is to 
follow the progress of your program during trace, 
but other uses are described on the next page. 


- 3 - 


Use it to serve as a work space. Exaroples of such 
uses include: 

• calculations 

• writing a subroutine while retaining a 
listing on the regular screen, toggling 
back and forth for reference 

§ modifyi ng your program, by adding or 
deleting lines, while retaining the roain 
listing on the regular screen 

• storing your data for quick reference, 
such as variables, listed lines, etc. 

• executing coromands, such as ENTER 
"D:filename.ext“ to merge a prograra with 
your current one 

• a general scratch pad, but, in contrast 
to the ATARI memo pad roode, all normal 
BASIC functions are still in effect 

The auxi1iary screen 1s totally independent of 
the regular screen, and will not accept graphic 
comroands, or attempts to change graphic modes. 
However, POKEs to locations that affect the display 
will be reflected in this screen, 1f it is being 
viewed when those POKEs take effect. For this 
reason, TRACE will be halted when you toggle to the 
auxi 1 i ary screen, to prevent thls frora acctdentally 
happening during the execution of a line. 

Now let's access the auxiliary screen. Type 
C0NTR0L-Z (reroember, hold down CTRL while hitting 
Z). The color of the screen border changed 1n the 
auxiliary screen, so that you can tell which screen 
you are viewing. The top of your screen should now 
read Auxiliary Screen as well, to 1dentify the mode. 

CAUTION: DO NOT change screens while BASIC 1s 
writing to the screen; your computer roay crash.. 
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Type CONTROL-Z again, to return to the regular 
screen. Let's put something on the regular screen; 
type LIST 1,100, and RETURN. The screen will fill 
with the first few lines of DEMO. Now type 
C0NTR0L-Z, and notice that the auxiliary screen is 
still clear. Let's do a quick calculation here. 
Type PRINT 256*PEEK(561 ) + PEEK(b60) and kETURN. 
This should print out the location of the display 
list, which will depend on the amount of memory in 
your ATARI. Hit C0NTR0L-Z again, just to see that 
your listing is still on the regular screen. Hit 
C0NT0L-Z again, and your calculation is still 
there, waiting for you. We can now clear this 
screen, by hitting ESC, followed by SHIFT-CLEAR. 
Your regular screen is still there (check if you 
don't believe it), but your auxiliary screen is now 
cleared for further action. Type LIST 101,200 and 
you will list the second part of DEMO to your 
auxiliary screen. You can now toggle back and 
forth between the two screens with C0NTR0L-Z. 
However, there i s a much better way to do thi s, and 
we'll try that next. 

SPLIT SCREEN 

Let's first clear both screens. Hit ESC ana 
then SHIFT-CLEAR to clear the auxiliary screen, and 
then C0NTRa-Z, followed by ESC and SHIFT-CLEAK to 
clear the regular screen. Now, to view the bottom 
of the regular screen and the top of the auxiliary 
screen at the same time, press SHIFT-C0NTR0L-D (all 
3 keys simultaneously) . The screen wil'1 be split 
by a horizontal white bar, and the lower half of 
the screen will have a light border, signifying the 
auxiliary screen. Now type LIST 1,100 and watch 
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what happens. The listing scrolls by on the top 
window, and what remains visib1e is the lower part 
of the listing. Now type C0NTR0L-Z, and then LIST 
101,200 and you should see the same thing happen in 
the bottom window. NOTE: since you are viewing 
only half of each screen, it is possible that you 
will not see the cursor in either window, since it 
may very well be in a portion of the screen which 
you cannot see. If this happens, use the cursor 
control keys to move 1t to a visible area agaln. 

You can still edit each screen in this mode. 
C0NTR0L-Z toggles between the two screens, and any 
changes you make in a program line in either window 
will be i ncorporated into your program. To clear 
either screen, put the cursor 1n that screen, and 
type ESC followed by SHIFT-CLEAR. 

To exit from the split-screen mode, type 
SHIFT- CONTROL-D a second time. Then let's clear 
the screen with ESC followea by SHIFT-CLEAR, and 
we'll move on to the next function. 

SCROLL 

The scrolling feature is accessed by typing 

either SHIFT-C0NTR0L- ♦ or SHIFT- C0NTR0L-4- . Uhen 
these coirmands are given, the prompt # will appear 
on the first free line above or below the lines 

currently listed on your screen. In this examp1e, 
your screen was clear, so you wlll now see the # 
symbol. Type 100 and RETURN, and llne 100 will 
appear on the screen. The default (a RETURN 

without a number) will start with the next line 

number after the one already on the screen. 

To continue scrolling up or down simply press 
the up arrow or down arrow (without pressing the 
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CONTROL key). Press the up arrow, and you will see 
additional lines of DEMO appear on the screen. 
Press the down arrow, and you will see the scroll 
go the other way. You can scroll through your 
whole program, line by line, very rapialy this 
way. If you scroll off the end of your program, 
the prompt NO MORE LINES appears on the screen in 
place of the expected line. No harm done-just 

start scrolling the other way. When you find a 
part of your program you want to change, just hit 
ar\y key other than the up or down arrows to exit 
the scroll mode, and make whatever changes you'd 
like to make. 

Thi s scrolling mode also works in the split 
screen mode. If you'd like to try it, enter the 
split screen mode with SHIFT-C0NTR0L-b, and then 
enter the scroll mode with SHIFT- CONTROL- 1 or 
SHIFT-C0NTR0L- ♦ . Enter the line number and 
RETURN, and scroll with the up or down arrow keys. 
Exit the scroll mode by hitting any other key, 
shift screens with C0NTR0L-Z, re-enter the scroll 
mode in thi s window with the SHIFT-CONTOL-arrows, 
type a line number and RETURN, and scroll this 
window i ndependently of the other window. Thi s 
gives you the ability to simultaneously edit two 
parts of your program, such as a calling routine 
and the subroutine it calls. This is a very 
powerful feature, and should be explored thoroughly 
on your own, to master it. 

TRACE 

The fundamental tool of MMa BASIC DEBUGCEk is 
the TRACE program, which allows you to trace the 
execution of a program line-by-1 ine. This feature 


is fundamental to ar\y BASIC debugger, and for this 
reason has the most number of options associated 
with 1t. To initiate the TRACE option, press 
CONTROL-T. The prompt ENTER TRACE OPTION will 
appear, allowing you to select the options you 
would like to use. First, let's do a standard 
TRACE. At the prompt, type RETURN, to get the 
defau1t options. On your regular screen, the one 
you are viewing now, you wil.l see the program DEMO 
being executed. Let 1t proceed for a bit, and then 
hit S to stop the TRACE. Now type C0NTR0L-Z to 
look at the auxil1ary screen. AHAHJ What you 

should see 1s a series of numbers, arranged neatly 
1n columns. These are the line numbers of DEMO, 

arranged in the order that they were executed. 

NOTE: not the order that they appear in the 

program, but the order 1n which the program flow 

executed them. By rev1ew1ng thls llst of line 
numbers, 1t is easy to TRACE the execution of your 
program, to determine whether or not 1t 1s 

performing the way you expected. Note that you may 
execute TRACE while viewing the aux111ary screen 
rather than the regular screen, 1f you simply want 
to see the line numbers. Try it! Type CONTROL-T, 
and at the prompt, type RETURN. You will see the 
line numbers appear as BASIC executes your 
program. Stop the listing with S, and toggle back 
to the regular screen wlth C0NTR0L-Z, to see the 
output of DEMO up until the point at which you 
stopped it. 

Mary different options are avai1able for this 
TRACE function, and they are briefly described on 
the following two pages. After the llst of the 
available options, we will be discusslng and using 
them in examp1es, but for now, just review them. 
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OPTION DESCRIPTION 

RETURN The default option 1s obtained by typing a 
RETURN without entering any options. This 
will TRACE startlng with the first line 
and list the line numbers executed to the 
auxiliary screen. 

nnn TRACE starting at line number nnn. The 
number must be at the beginning of the option 
line. Line numbers executed are listed to 
the auxiliary screen during TRACE if no other 
options are selected. 

Rnnn Run to line number nnn, and then begin 
TRACE. This command allows you to get past 
parts of the program that are already 

debugged, or to get by ini tial ization 

routines. This option must be at the 

beginning of the option line, and it may not 
be used with the nnn option above. 

S In STEP TRACE mode, one line is executed each 
time the space bar is pressed. You can 

toggle between STEP TRACE and TRACE by 
pressing T at any time during a TRACE. 

L LISTs executed lines to the auxiliary 
screen. This option 1s slower than just 
listing the line numbers, but 1t does allow 
you to examine each 11 ne as 1t is executed. 

V Thls option prlnts the YALUEs of up to five 
variables (scaler, array or string variables 
are allowed) to the aux111ary screen as you 


TRACE. After the cor.*nand line has been 
chosen, MMG BASIC DEBUGGER will request each 
variable, one at a time. After typing in a 
variable name, hit RETURN and you will be 

asked for the next variable name. If you 

don't wish to enter any more variables, just 
hi t RETURN. 

W TRACE WHILE will cause the TRACE to change 
to STEP TRACE when a condition is no longer 
true. Thi s option allows you to test the 

value of a scaler variable (array or string 
variab1es are not allowed) against a va1ue 
and conditions of your choice. Test 
conditions allowed are greater than, less 
than, equal to, or not equal to. After the 
TRACE options have been selected, you will 

be asked for the variable, the condition, 
and the test value before beginning the 

TRACE. For example, you could decide to 
TRACE WHILE XSET was less than 3. When XSET 
was greater than or equal to 3, TRACE would 
change to STEP TRACE, allowing you to single 
step through your program from that point on. 

C CONTINUE where you 1eft off. If you 

temporarily stopped the TRACE to change a 
variable or enter a new line to your 
program, this command allows you to restart 
the program where you left off. 

P PRINT all output (GRAPHICS 0) to the printer. 

PA PRINT only the AUXILIARY screen output to 

the printer. 
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IMPORTANT NOT E : the TRACE function will NOT 

tracĕ through tFie following BASIC commands: RUN, 
LOAD, STOP and LIST. It also requires line 0 for 
its own use, so if you have a line 0, renumber it 
before TRACEing your program. 

Let‘s try some examples of the diffenent TRACE 
modes. We have already seen the default option, 
which prints the line numbers of the executed lines 
to the auxi1iary screen. This is accessed from the 
TRACE program by just hitting RETURN in response to 
the prompt. Sornetimes, however, you would rather 
see the whole BASIC line, rather than just the line 
number, as each line is executed. To accoinplish 
thi s, type L at the prompt, and RETURN. The TRACE 
will start. Let it go for a few seconds, and stop 
it with the S key. Then toggle to the auxiliary 
screen with C0NTR0L-Z, and you will see each line 
of the DEMO program listed there, in the order that 
tney were executed! 

Since the TRACE option just proceeds through 
your program line-by-line, wouldn't it be nice to 
be able to single-step through, rather than all at 
once? You can! Re-enter the regular screen with 
C0NTRa-Z, and the TRACE option with CONTROL-T. 
Respond to the TRACE prompt with S, and then hit 
RETURN. The first line of DEMO will be executed, 
and the computer will stop, waiting for you to hit 
the space bar. When you do, the next line in the 
program flow will be executed. Note that this is 
not necessari ly the second line of your program, 
but will be the second line executed. Type S now, 
to stop the TRACE, and toggle to the auxiliary 
screen to see the line numbers of the lines 
executed. We will now introduce a new option, C 
(for Continue). Let's type CONTROL-T to enter the 
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TRACE mode while we watch the auxiliary screen. In 
response to the prornpt, type CS and hit RETURN. To 
execute more than one option of the TRACE program 
at a time, just type in the option codes, in any - 
order, all on a line, with no spaces, and tollow 
them with a RETURN. The auxiliary screen will now 
list a new line number each time you hit the space 
bar, allowing you to single-step through your 
program, while watching either the program's output 
on the regular screen, or the program flow, on the 
auxiliary screen. We could have typed CSL if we 
had wanted to see the whole BASIC line, rather than 
just the line numbers, on the auxiliary screen. 

Any of the options can be made to begin at some 
place in your program other than at the beginning, 
simply by starting your response to the TRACE 
prompt with a line number. For instance, 100S will 
begin STEP TRACE at line 100, or 200 just followed 
by RETURN will start a regular TRACE at line 200. 
Often, however, the beginning of your BASIC program 
has certain start-up or set-up routines which are 
required for some later part to function 
correctly. Beginning the TRACE in the midale of 
such a program will not work, so MMG BASIC DEBUGGER 
has the R (RUN) option provided for such cases. If 
you type R100SL, for example, DEMO will run to line 
100, and then enter the STEP TRACE moae, printing 
entire BASIC lines to the auxiliary screen. Other 
combinations of commands using the RUN option 
should be explored for full understanding of this 
mode. 

The V option of TRACE 1s particularly useful 
when you think that your program is ma1fuct1oning 
because some variables are being incorrectly 
assigned values. To demonstrate this option, enter 
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TRACE and type V S in response to the prompt, for 
the Yarlable option STEP TRACE. The screen will 
then ask you for a yariable name. Type LINE, and 
hit RETURN. You will then be asked for a second 
vari able name, and so on, up to five, if you so 
desire. Type I for the second variable, and X for 
the third. At the fourth request, just type 
RETURN, which will begln the TRACE. Hit the space 
bar 10 times, and stop the TRACE by hitting the S 
key. Toggle to the aux11iary screen. You should 
see the names of the var1ables you selected, LINE, 
I, and X, printed on the top of the screen, and the 
values of each of the variab!es printed 1n columns, 
with each row representing the va1ues of the 
variab1es fo11owing the execution of one line of 
DEMO. This option eliminates the need for PRINT 
statements all through your program to tell you 
what va1ues the var1ables have at any point! 

If you have a printer, you'11 appreciate the P 
and PA options of TRACE. Include P on the conwnand 
line fol1owing the TRACE prompt, and all GRAPHICS 0 
output will be printed on your printer, for a 
permanent record. PA will print only the output 
normally directed to the aux111ary screen to your 
printer. Neither of these options will have any 
effect on the output to elther screen. Note that 
1f your printer 1s not on, or you don't have a 
printer connected, the TRACE proceeds anyway. The 
lack of a printout should be a strong clue to the 
problem! 

F1nally, the last option is W, for TRACE 
WHILE. Thls mode 1s a conditional TRACE. In 
response to the TRACE prompt, type WL, which will 
enter the TRACE WHILE mode, llsting whole BASIC 
lines to the auxiliary screen. The screen will 
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prompt you for the conditional variab1e; that is, 
the variable upon which you would like to make the 
TRACE dependent. Type LIHE, and follow it by a 
RETURN. You will then be asked for the condition; 
that is, greater than, less than, equal to, or not 
equal to. Type the greater than {> ) key, and 
RETURN. Finally, you will be asked for the value 
you wish to test against. Type 200 and RETURN. 
What you have done is to tell the computer to TRACE 
until the variab1e LINE 1s greater than 200, and 
then to change to STEP TRACE, all the time listing 
entire BASIC llnes to the auxi1iary screen. 
Experiment with thls option, and you will find it 
to be extremely valuable in debugging your programs. 

KEYBOARD INPUT 

Duri ng TRACE, the keyboard 1s disabled except 
for the S, D and T keys. The S key halts TRACE, 
the D key allows you to toggle between the regular 
screen and the auxi1iary screen while 1n TRACE 
mode, and the T key toggles between TRACE and STEP 
TRACE. The normal function of the keyboard can be 
enabled by pressing CONTROL-ESC. Another 

COHTROL- ESC toggles back to the disabled keyboard. 
Thi s toggling is automatic if your BASIC program 
needs keyboard input. Should you ever find your 
keyboard unresponsive to input, try hltting 

CONTROL- ESC to re-enable it. 

SEARCH 

You can SEARCH a program for any sequence of 
characters, strings, BASIC statements or commands, 
by pressing SHIFT-C0NTR0L-S (you must hit all 3 


-14- 


keys simultaneously). The prompt ENTER STRING FOR 
SEARCH will appear. Enter the strlng you wlsh to 
search for, and press RETURN. The prompt LINE 
NUMBERS F0R SEARCH wlll next appear, allowing you 
to choose the block of lines to be searched. dust 
pressing RETURN at this polnt will cause the search 
to be conducted for all lines in your BASIC 
program. After typing RETURN, the search will 
begin. To search a 200-line BASIC program will 
require about 5 seconds. 

CROSS REFERENCE 

You can also produce a listing of a 

cross- reference table for the variables in your 
program, by typing SH IFT- CONTROL- R (all 3 keys 
simultaneously) . The program will ask you if you 
want the output directed to a printer (in addition 
to the screen); if you type Y the output will also 
appear on your printer. Any other key causes 
output to be directed only to the screen. 

The CROSS REFERENCE lists all variab1es in your 
program in alphabetical order with the line numbers 
on which they occur listed with them. CONTROL-1 
will temporarlly halt the llstlng for you to 
inspect 1t, and a second CONTROL-1 will restart 1t 
again. Exit this mode by hitting the BREAK key. 

BREAK KEY ANO SYSTEM RESET 

The BREAK key and SYSTEM RESET key are enabled 
during a TRACE but use only the S key, if at all 
possible. The S key will stop the program under 
the most controlled condltions and the program can 
be restarted (using the C option) from the same 
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place. However, if the BREAK key is used, the C 
option in TRACE will not start the program again. 

SYSTEM RESET does what it wants to do at all 
times, and if you press SYSTEM RESET during a 
TRACE, your program may be altered, giving you an 
opportunity to load from your back-up copy. (You 
did have a back-up copy, didn't you? We warned 
you'. ) Even hitting SYSTEM RESET will not affect 
Mf-li BASIC DEBUG6ER, however. It will remain there 
for your use, whenever you need it. 


We very much hope you enjoy MMG BASIC DEBUGGER, 
and that it makes your life easier, as it has 
ours. If you have comments or suggestions, we'd 
love to hear them. Please write and let us know. 


LIMITED WARRANTY 


This soliwaie prorluci is sold “AS IS”. withoui warranty as toits performance. Theentire nsk astothequality 
and perlormance o( the computer soltware program is assumed by the user The user, and not the 
manutacturer, distributor or retailer assumes the enttre cost of all necessary service or repair to the computer 
sotl ware program. 

The above wanranty ia in lieu of all other expresa warranties and of implied warranties or 
merchantability and litness for a particular purpose or any other warranty obligation on the part of 
MMG Micro Software shall be limited to replacement o I the original software program, should it 
become defective within the first ninety (90) days of use by the original purchaser. Some states do 
uot allow limitations on how long an implied warranty lasts, so the above limitation may not apply to 
you. In no event shall MMG Micro Software or anyone clse who has been involved in the creation 
and production of this computer soltware program be liable for indirect, special, or consequential 
damages, such as, but not limited to , loss of anticipated prolits or benefits resulting from the use of 
this program, or arising out of any breach of this warranty. Some states do not allow the exclusion 
or limitation of incidental or consequential damages so the above limitation may not apply to you. 
This wari anty gives you specilic legal rights, and you may also have other rights which vary from 
stale to slaie. 

The user of tlus prodm t shall be enlitled to use the product lor his/ her own use. but shall not be entitied to sell 
or transler reprmhictious ot the product or instructional materials to other parties in any way. 



